home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
opus
/
oufm140.zip
/
OUFM138.DOC
next >
Wrap
Text File
|
1992-05-03
|
49KB
|
1,290 lines
OUFM.EXE v1.38
Opus User File Manager
Released: 3 May 1992
Copyright 1989-1992 by Trevor B. Roydhouse
ALL RIGHTS RESERVED
Sentry BBS (FidoNet 3:711/401 - PEP)
Australia (02) 428-4687 - International +61-2-428-4687
Sentry's Shadow BBS (FidoNet 3:711/501 - V32)
Australia (02) 418-6682 - International +61-2-418-6682
TABLE OF CONTENTS
Introduction ......................................... 1
Requirements ......................................... 1
OUFM syntax and usage .................................1
Navigating the edit boxes ............................ 3
OUFM commands - Introduction ......................... 4
Global commands ...................................... 4
Field editing commands ............................... 10
Top edit box commands ................................ 10
Middle edit box commands ............................. 12
Bottom edit box commands ............................. 14
Unknown commands ..................................... 15
Revision history ..................................... 16
Bugs/Mites/Suggestions ............................... 20
License .............................................. 21
Disclaimer of liability .............................. 21
Latest version ....................................... 21
Opus User File Manager v1.38 Page 1
INTRODUCTION
This version of OUFM (Opus User File Manager) was written to make
management of the Opus 1.7x user file easy ... well, easier.
OUFM has built-in time slicing support for those running their systems
under the DESQview or DoubleDOS multitaskers. There is also the -b
command line switch to make OUFM use BIOS screen writes rather than
the default direct video RAM screen writes.
Thanks to various sysops who sent code, OUFM now automagically detects
those who are running their systems on Novell LANs and no longer
requires the -n command line switch.
This release of OUFM will only work at the local console, not remotely
over the modem unless you are using a program like DOORWAY to redirect
direct video RAM screen writes.
REQUIREMENTS
OUFM requires PC/MS-DOS v3.00 or greater, a monochrome or colour
monitor, and a minimum of 120K RAM available to run the program.
OUFM SYNTAX AND USAGE
OUFM may be run from any directory. You do not have to run OUFM from
the same directory as that in which your USER.DAT and USER.NDX files
are located. If you do not run it from that directory, you need to
specify a fully qualified DOS pathname when invoking OUFM (see below).
Whenever OUFM is run, it checks the index file which corresponds with
your user file. If there is no corresponding index file or the index
file is found to be corrupt, OUFM will generate a new index file and
continue. This index check is very picky to ensure noone could log on
to your system with their name but your privileges.
Syntax: OUFM {[fname lname] [-b] [-h] [-s] [-n] [/filename]}
fname lname
The fname (first name) and lname (last name) of user whose record is
to be displayed on loading. A case insensitive search is done on these
parameters and if successful, the record for the specified user will
be displayed instead of the first user record.
Page 2 Opus User File Manager v1.38
NOTE: fname & lname must be the first arguments specified on the
command line.
-b
Instructs OUFM to use BIOS screen writes instead of the default direct
video RAM screen writes. This option should be used by those running
their systems under multitaskers if OUFM "bleeds" through into other
partitions or by those whose systems are only compatible at the BIOS
level.
-h
Instructs OUFM to hide the passwords of ALL users. If specified, then
<Hidden> will be displayed instead of the user's password. This option
may also be enabled or disabled after OUFM has been started. See the
section detailing OUFM commands below.
NOTE: for security reasons, the password of a user with sysop
access is always hidden except when being changed.
-s
Instructs OUFM to use small buffers for disk input/output. Saves
approximately 20K of memory if you do not have much to spare. However,
it should be noted that use of this option will significantly SLOW any
disk input/output operations.
-n
Provided for compatibility with Novell's netware drivers. Strictly
unnecessary now that OUFM automagically detects Novell's Netware
drivers.
/pathname
Instructs OUFM to use the specified alternative user file pathname.
The pathname must include the directory (if not the directory from
which OUFM was invoked) and must include the stem of the user file
name which is also used to find the corresponding index file (see the
examples below).
The default user file name of USER.DAT is assumed unless another is
specified with this option. The default user file extension of .DAT is
also assumed unless another is specified.
For example:
/K:\OPUS\USER --> k:\opus\user.dat & k:\opus\user.ndx
/K:\OPUS\USER.DAT --> k:\opus\user.dat & k:\opus\user.ndx
Opus User File Manager v1.38 Page 3
/K:\OPUS\USER.REC --> k:\opus\user.rec & k:\opus\user.ndx
/K:\OPUS\WEIRD --> k:\opus\weird.dat & k:\opus\weird.ndx
/K:\OPUS\WEIRD.XXX --> k:\opus\weird.xxx & k:\opus\weird.ndx
NAVIGATING THE EDIT BOXES
Set out below is a typical OUFM screen:
╔══════════════════════════════════════════════════════════════════════════════╗
║ R)ecno : 1 of 343 ID: 0661353901 First call date not logged ║
║ ║
║ N)ame : Trev Roydhouse A)ccess: Sysop ║
║ U)ser : P)asswd: <Hidden> ║
║ S)treet: Box 1605 Macquarie Centre D) of B: 18 Jun 1957 ║
║ C)ity : NSW 2113 T)eleph: 428-4687 ║
║ ║
║ K)eys : ABC-----------------------012345 B)alanc: $4.80 (9.42) ║
╚══════════════════════════════════════════════════════════════════════════════╝
┌──────────────────────────────────────────────────────────────────────────────┐
│ L)ast : 02 May 92 09:15 01 days @)menu: Main F)iles: 321 │
│ X)piry: n/a C)alls: 2111 M)sgs : 16 U)load: 4359 K │
│ mins: n/a T)oday: 31 P)ost : 285 D)load: 19447 K │
│ A)ctn : None O)nlin: n/a S)een : 71391 /)limt: 0 K │
│ │
│ W)elcm: Sysop SPANN : 1) 000 2) 000 3) 000 4) 000 5) 000 │
└──────────────────────────────────────────────────────────────────────────────┘
┌──────────────────────────────────────────────────────────────────────────────┐
│ H)elp : HiTech I)bm Gr: Yes L)en : 24 B)lock: Yes D)efPr: Z │
│ V)ideo: ANSI O)pEd : Yes W)idth: 80 C)lock: Yes │
│ F)lash: Yes S)crClr: Cls N)ulls: 0 P)ubln: NCT │
│ M)ore : Yes A)sk Gr: Yes :)lang: 01 T)alkr: No │
│ X)tab : No U)sedB4: Yes Q)menu: No E)menu: No │
└──────────────────────────────────────────────────────────────────────────────┘
The currently selected or active "edit box", in this case the top edit
box, is indicated by a double lined border. All non-selected or non-
active edit boxes have a single line border.
You can change edit boxes by using the CURSOR UP and CURSOR DOWN arrow
keys. If the top edit box is selected, you can change to the bottom
edit box by pressing the CURSOR UP key. Similarly, if the bottom edit
box is selected, you can change to the top edit box by pressing the
CURSOR DOWN key.
Page 4 Opus User File Manager v1.38
OUFM COMMANDS - Introduction
OUFM has four sets of commands:
1) Global commands that work no matter which edit box you have
selected;
2) Commands that only work when you select the top edit box;
3) Commands that only work when you select the middle edit box;
and
4) Commands that only work when you have selected the bottom edit
box.
GLOBAL COMMANDS
The complete set of OUFM global commands is set out below:
ESC
The escape key will exit the program and return you to DOS.
HOME
The home key or the B key displays the first record in the user file.
This record should contain the sysop's details.
END
The end key or the E key displays the last record in the user file.
CURSOR LEFT
The cursor left arrow key or the minus sign key displays the next user
record, if there is one.
CURSOR RIGHT
The cursor right arrow key or the plus sign key displays the previous
user record, if there is one.
CURSOR UP
The cursor up arrow key changes the selected edit box to the one
Opus User File Manager v1.38 Page 5
above. If the top edit box is selected, the display will wrap around
and select the bottom edit box.
CURSOR DOWN
The cursor down arrow key changes the selected edit box to the one
below. If the bottom edit box is selected, the display will wrap
around and select the top edit box.
PGUP
The page up key toggles the first of the two extra top edit box
information displays which shows the sysop defined section (if any)
and the user defined sections (if any).
PGDN
The page down key toggles the second of the two extra top edit box
information displays which shows the sysop comment (if any) and the
user supplied answer to the sysop defined logon question for new
users.
=
The equals key activates the manual search function. When activated, a
pop-up menu appears showing the fields on which you can search.
The fields are:
N)ame #) number of calls Z)apped records
U)ser alias K)ey .) tagged records
C)ity M)sg area B)irthdate
T)elephone number F)ile area
P)assword A)ccess level
D)ays since last call S)pann#
Notes:
The D)ays since last call search will match on any user record where
the number of days since the user's last call is equal to or greater
to the number specified. If you wish to match only on those user
records where the number of days is equal to the number you select,
then append a trailing = sign immediately after the number (eg 100=).
The number of days is calculated on the number of hours since the last
call. This means that if the user last called on 17 March 1990 at 9pm,
up until 9pm on 18 March 1990 the user will not be matched if you do a
search for callers in the last 1 day. On the other hand, you will get
a match on any user who has called 1 or more days ago.
The #) number of calls search will match on any user record where the
Page 6 Opus User File Manager v1.38
number of calls is greater than or equal to the number specified. If
you wish to match only on those user records where the number of calls
is equal to the number you select, then append a trailing = sign
immediately after the number (eg 1000=).
The S)pann# search will match on the SPANN# specified in any user
record where the counter for that SPANN# is greater than zero.
The Z)ap status search will match on any user record which has been
zapped and is currently showing the PURGE flag.
The search on ASCII fields (e.g. name, comment, myanswer, password,
telephone number etc) is a substring search and is case insensitive.
For example, a search on the name field for "vau" will match on Max
Vaughan-Williams and on Matt Mavau.
When using the manual search, you will be prompted with:
Continue Search? [Y/n/t/z]
The default answer (just press ENTER) is Yes. The other options are
No, Tag this record and continue and Zap this record and continue.
A sample screen display showing the search menu is set out below.
╔══════════════════════════════════════════════════════════════════════════════╗
║ R)ecno : 1 of 343 ID:╔═════════════╗ First call date not logged ║
║ ║ Search for: ║ ║
║ N)ame : Trev Roydhouse ║ ║ A)ccess: Sysop ║
║ U)ser : ║ N)ame ║ P)asswd: <Hidden> ║
║ S)treet: Box 1605 Macquarie Ce║ U)ser Alias ║ D) of B: 18 Jun 1957 ║
║ C)ity : NSW 2113 ║ C)ity ║ T)eleph: 428-4687 ║
║ ║ T)elephone ║ ║
║ K)eys : ABC------------------║ P)assword ║ B)alanc: $4.80 (9.42) ║
╚═══════════════════════════════║ D)ays since ║════════════════════════════════╝
┌───────────────────────────────║ #) calls ║────────────────────────────────┐
│ L)ast : 02 May 92 09:15 01 ║ K)ey ║ain F)iles: 321 │
│ X)piry: n/a C)alls: 211║ M)sg Area ║6 U)load: 4359 K │
│ mins: n/a T)oday: 31 ║ F)ile Area ║85 D)load: 19447 K │
│ A)ctn : None O)nlin: n/a║ A)ccess ║1391 /)limt: 0 K │
│ ║ S)pann# ║ │
│ W)elcm: Sysop SPANN : 1) ║ Z)apped ║3) 000 4) 000 5) 000 │
└───────────────────────────────║ .) Tagged ║────────────────────────────────┘
┌───────────────────────────────║ B)irthdate ║────────────────────────────────┐
│ H)elp : HiTech I)bm Gr: Yes╚═════════════╝ B)lock: Yes D)efPr: Z │
│ V)ideo: ANSI O)pEd : Yes W)idth: 80 C)lock: Yes │
│ F)lash: Yes S)crClr: Cls N)ulls: 0 P)ubln: NCT │
│ M)ore : Yes A)sk Gr: Yes :)lang: 01 T)alkr: No │
│ X)tab : No U)sedB4: Yes Q)menu: No E)menu: No │
└──────────────────────────────────────────────────────────────────────────────┘
The following different search boxes will appear if PGDN or PGUP are
currently toggled:
Opus User File Manager v1.38 Page 7
╔═════════════╗ ╔═════════════╗
Page Down ║ Search for: ║ Page Up ║ Search for: ║
║ ║ ║ ║
║ N)ame ║ ║ N)ame ║
║ U)ser Alias ║ ║ U)ser Alias ║
║ P)assword ║ ║ P)assword ║
║ D)ays since ║ ║ D)ays since ║
║ #) calls ║ ║ #) calls ║
║ ║ ║ ║
║ A)ccess ║ ║ A)ccess ║
║ S)pann# ║ ║ ║
║ ║ ║ S)ection ║
║ M)yAnsr ║ ║ M)sg UDS ║
║ C)omment ║ ║ F)il UDS ║
║ ║ ║ ║
║ Z)apped ║ ║ Z)apped ║
║ .) Tagged ║ ║ .) Tagged ║
║ B)irthdate ║ ║ B)irthdate ║
╚═════════════╝ ╚═════════════╝
ALT =
Holding down the ALT key and pressing the equals keys activates the
search function which automatically tags the user records that match
the search criteria. The search fields are as for the manual search
above.
ALT C
Holding down the ALT key and pressing the C keys activates the search
function which automatically tags ONLY those user records that match
the search criteria AND are already tagged. Any already tagged user
record which does not match the current search criteria will be
untagged. This allows combination tagging (ie tagging of all user
records which match multiple search criteria). The search fields are
as for the manual search above.
G
The G key activates the global change function. When activated, a pop-
up menu appears showing the fields which you can globally change (ie
change in every user record). The options on the menu are:
R)eset UsedB4 - Allows you to reset the configuration bit so
that Opus will treat the user as a new user
on the next call (the user will not be asked
for a new password). OUFM will prompt you to
confirm this choice before executing it.
1-5 - Allows you to specify the number of times each
special announcement bulletin should be shown
Page 8 Opus User File Manager v1.38
to users at logon. These bulletins replace the
normal welcome file until the display counter
reaches 1.
A)dd key - Allows you to add the specified key to all user
records.
D)elete key - Allows you to delete the specified key from all user
records.
T)oggle key - Allows you to toggle the specified key in all user
records (ie if it is already on, turn it off AND if
it is already off, turn it on).
U)ntag all - Allows you to remove the TAGGED status from all
user records. Essential now that OUFM has many new
options which allow tagging!
See the sample screen below for the global changes pop-up menu.
╔══════════════════════════════════════════════════════════════════════════════╗
║ R)ecno : 1 of 343 ID╔════════════════╗ First call date not logged ║
║ ║ Global Changes ║ ║
║ N)ame : Trev Roydhouse ║ ║ A)ccess: Sysop ║
║ U)ser : ║ R)eset UsedB4 ║ P)asswd: <Hidden> ║
║ S)treet: Box 1605 Macquarie C║ ║ D) of B: 18 Jun 1957 ║
║ C)ity : NSW 2113 ║ 1) Spann1 ║ T)eleph: 428-4687 ║
║ ║ 2) Spann2 ║ ║
║ K)eys : ABC-----------------║ 3) Spann3 ║ B)alanc: $4.80 (9.42) ║
╚══════════════════════════════║ 4) Spann4 ║══════════════════════════════╝
┌──────────────────────────────║ 5) Spann5 ║──────────────────────────────┐
│ L)ast : 02 May 92 09:15 01║ ║n F)iles: 321 │
│ X)piry: n/a C)alls: 21║ A)dd key ║ U)load: 4359 K │
│ mins: n/a T)oday: 31║ D)elete key ║ D)load: 19447 K │
│ A)ctn : None O)nlin: n/║ T)oggle key ║91 /)limt: 0 K │
│ ║ ║ │
│ W)elcm: Sysop SPANN : 1)║ U)ntag all ║ 000 4) 000 5) 000 │
└──────────────────────────────║ ║──────────────────────────────┘
┌──────────────────────────────╚════════════════╝──────────────────────────────┐
│ H)elp : HiTech I)bm Gr: Yes L)en : 24 B)lock: Yes D)efPr: Z │
│ V)ideo: ANSI O)pEd : Yes W)idth: 80 C)lock: Yes │
│ F)lash: Yes S)crClr: Cls N)ulls: 0 P)ubln: NCT │
│ M)ore : Yes A)sk Gr: Yes :)lang: 01 T)alkr: No │
│ X)tab : No U)sedB4: Yes Q)menu: No E)menu: No │
└──────────────────────────────────────────────────────────────────────────────┘
!
The exclamation point activates the "shell" option. OUFM first asks
for the name of the program you wish to run and then for the command
line arguments (if any). To save memory, only a 2.8K stub of OUFM
remains in memory, the rest of OUFM is written to disk in a temporary
file. After the chosen program terminates and this "stub" reloads OUFM
from the temporary disk file which is then deleted. If you choose to
Opus User File Manager v1.38 Page 9
shell to DOS by entering COMMAND at the program name prompt, you must
type EXIT to return to OUFM.
#
The hash key activates the function which checks the user file index
containing the btree index of the names in the user file. If an error
is found, then OUFM regenerates the index file. It should not be
necessary to use this function as OUFM checks the index file whenever
it is invoked, and automatically regenerates the file when a user's
name is changed, the user records are purged or a new record is
inserted.
R
The R key lets you specify the record number which you wish to
display.
Z
The Z key is used to Zap the currently displayed user record. The
user record is not immediately deleted, merely marked for later
deletion by the purge function (see the DEL command). When a user
record has been Z)apped, this fact is shown by displaying PURGE
in reverse video in the top left of the display above the user's
name.
*
This command updates the caller ID field in the user record. You
should not need to use this command in normal circumstances.
DEL
The delete key activates the purge function which deletes all user
records which have been zapped. OUFM then repacks the user file and
regenerates the index file. Before the deletion takes place, OUFM will
ask you whether you wish to save the deleted records. If you answer
Yes, then the records will be saved to a file with the name USER.OLD
(assuming you are using the deualt user fileanme of USER).
Note: OUFM will not execute this command if there is an ACTIVE##.DAT
file in the USER.DAT directory as this indicates that a user is online
and that it is extremely unsafe to change the relative position of
records in the user file.
INS
The INS key inserts a new user record at the end of the user file and
Page 10 Opus User File Manager v1.38
then regenerates the index file. You should edit the user record to
change the default selections, especially the name which defaults to
"New Record".
.
The "point" or "full stop" key will tag the current user record; that
user record will then display TAGGED in reverse video in the top left
of the top edit box.
ALT O
Holding down the ALT key and pressing the O key brings up the option
to write brief details of tagged records to either a disk file or a
device (eg use PRN for the printer). If you append a plus sign to a
filename, the details will be appended to that file, otherwise the
file will be overwritten by the new one. Before the records are
output, you will be asked to supply a header line to be included in
the file -- specify something which will remind you why you selected
these records!
The details currently written to the file are Record number, Name,
City, Telephone number, Last call date, Number of days since last call
and Password. I'm open to suggestions.
FIELD EDITING COMMANDS
When editing an ASCII field in the edit boxes, the following edit keys
are available:
INS - inserts a space character which may be overwritten
DEL - deletes a character from the right of the cursor
CUL - moves the cursor to the left
CUR - moves the cursor to the right
HOME - moves the cursor to the beginning of the field
END - moves the cursor to the end of the field
BKSPC - deletes a character to the left of the cursor
ESC - aborts the editing and restores the original field
TOP EDIT BOX COMMANDS
In addition to the commands discussed above, the following commands
are available when the top edit box is selected:
H
The H key toggle the hide all passwords function on/off. If on, then
Opus User File Manager v1.38 Page 11
<Hidden> is displayed instead of the password for the user whose
record is currently displayed.
NOTE: for security reasons, the password for a user with sysop
access is always hidden except when being edited.
I
The I key will import a file called USER.OLD (or a file with the same
name as your user file, but with the extension .OLD) into the user
file. User.old files are generated by some user file managers when
records are deleted. For example, when you delete user records using
OUFM you have the option of saving those records to a file called
USER.OLD.
In addition to the above commands, the following commands are
available (these commands are actually displayed in the top edit box
unless you have toggled either the PGDN or PGUP extra info displays):
R)ecno - Allows you to specify the record number which you wish to
display.
N)ame - Allows the editing of the user's name.
U)ser - Allows the editing of the user's alias which Opus will
optionally ask for when a new user logs on.
S)treet - Allows the editing of the user's location details.
C)ity - Allows the editing of the user's location details.
K)eys - Allows editing of the user's keys.
A)ccess - Allows the changing of the user's access level. Activates
a pop-up menu of possible available access levels. NOTE:
R)egd is for use only where your system is private and
reqires users to be pre-registered (i.e. already in the
user file when they call).
P)asswd - Allows the editing of the user's password.
D) of B - Allows the editing of the user's date of birth.
T)eleph - Allows the editing of the user's telephone number which
Opus will optionally ask for when a new user logs on.
B)alance - Allows the editing of the user's netmail balance. The
amount entered is the credit which the user will have for
netmail charges. You may also reduce or increase the
cumulative debit which is shown in parentheses after the
balance. If you enter a number with a trailing minus
sign, this will reduce the debit by that amount. If you
enter a negative number (ie you precede the number with a
minus sign) and also append a trailing minus sign, you
Page 12 Opus User File Manager v1.38
will increase the debit by that amount.
If you have toggled the Page Down extra information display, the
following additional commands are available:
C)omment - Allows you to edit the 67 character field for a sysop-
supplied comment about the user. Be nice and friendly!
M)yAnsr - Allows you to edit the user-supplied answer to the
optional sysop-defined question asked of new users on
their first logon.
If you have toggled the Page Up extra information display, the
following additional commands are available:
S)ectn - Allows you to edit the sysop-defined section (if any).
The section name must correspond with one which you have
defined in the Opus BBS.CTL file. Refer to the Opus
Technical Reference Manual and Opus Sysop Operations
Manual for more details. You must also edit the character
field to show the first character of the section name.
C)haracter - Allows you to edit the section character field to match
the first letter of the sysop-defined section.
M) UDS - Allows you to delete message areas from the user-defined
section.
F) UDS - Allows you to delete file areas from the user-defined
section.
MIDDLE EDIT BOX COMMANDS
In addition to the commands discussed above, the following commands
are available when the middle edit box is selected:
L)ast - Allows the changing of the user's last call date. You may
either have today's date and time automatically entered
or enter the date and time manually.
T)oday - Allows the changing the number of minutes a user was
online in the last 24 hours.
O)nline - Allows the changing of the number of minutes used by a
user (used in conjunction with the X)piry option when
the expiry method is by time -or- by date and time).
@)menu - Allows the setting of the menu at which the user logged
off from. This option would not generally be used.
Opus User File Manager v1.38 Page 13
M)sgs - Allows the setting of the message area a user will enter
next time he logs on. Until changed, it shows the number
of the last area accessed.
F)iles - Allows the setting of the file area a user will enter
next time he logs on. Until changed, it shows the number
of the last area accessed.
P)osted - Allows editing of the number of messages posted by this
user.
S)een - Allows editing of the number of messages "seen" by this
user (ie read, or at least scrolled through).
X)piry - Allows the setting of the expiry method. Activates a pop-
up menu which gives you a choice of time (number of
minutes before access expires), date (the Annual option
on this menu will take today's date and add 1 year), date
and time combined, or no expiry method. This command is
used in conjunction with the A)ction command (see below).
C)alls - Allows the editing of the number of calls a user has made
to your system.
U)pload - Allows the editing of the number of kilobytes a user has
uploaded to your system.
D)ownload - Allows the editing of the number of kilobytes a user has
downloaded from your system.
/)limit - Allows editing of the download limit for the current 24
hour period. This number is the total number of kilobytes
downloaded in the current 24 hours.
A)ction - Allows you to specify the action to be taken when a
user's access to your system expires by time or date or
both. Activates a pop-up menu which gives you a choice of
axing the user (denying the user further access),
demoting the user to TWIT or the expiry privilege level
set in the BBS.CTL Opus control file, or both.
W)elcome - Allows the definition of a substitute welcome file to be
shown to this user at logon. The filename is limited to 8
characters; the .BBS filename extension is assumed by
Opus. Handy for the sysop or for specified groups of
users.
1) - Allows the setting of the display counter for the special
announcement bulletin file SPANN1.BBS
2) - Allows the setting of the display counter for the special
announcement bulletin file SPANN2.BBS
3) - Allows the setting of the display counter for the special
announcement bulletin file SPANN3.BBS
Page 14 Opus User File Manager v1.38
4) - Allows the setting of the display counter for the special
announcement bulletin file SPANN4.BBS
5) - Allows the setting of the display counter for the special
announcement bulletin file SPANN5.BBS
BOTTOM EDIT BOX COMMANDS
In addition to the global commands discussed above, the following
commands are available when the bottom edit box is selected:
H)elp - Allows the setting of the user's help level. Toggles the
help setting from Novice -> Regular -> Expert -> HiTech
(HotFlash) and wraps around to Novice.
V)ideo - Allows the selection of the video mode. Toggles the video
setting from TTY -> Avatar -> ANSI and then wraps around
to TTY.
F)lash - Allows the selection of hotkeys (ie the user does not
have to press enter after entering commands at Opus
menus.
M)ore - Toggles the selection of the more prompt. If set on, the
user is prompted with More [Y,n,=]? at each full screen
of data.
X)tab - Toggles the selection of tabs. If set to YES, tabs are
eXpanded and spaces are sent to the user. If set to NO,
tabs are sent "as is".
I)bm - Toggles the selection of IBM characters. If set on, Opus
sends IBM characters (ASCII above decimal 127) to the
user.
O)pEd - Toggles the selection of the Opus full screen editor.
S)crClr - Toggles the selection of screen clearing. Seems to only
work in Avatar and ANSI video modes.
A)sk Gr - If set to YES, the user will be asked the question about
their graphics configuration at every logon. If set to
NO, Opus will default to the grahpics configuration
supplied by the user on their first logon.
U)sedB4 - Toggles the Opus configuration bit on/off. If set to YES,
the user has answered the Opus logon questions regarding
user settings. If set to NO, the user has not called
before or since the bit was reset. NOTE: this setting
maybe be globally changed, see the G)lobal change command
above.
Opus User File Manager v1.38 Page 15
L)en - Allows the editing of a user's screen length.
W)idth - Allows the editing of a user's screen width.
N)ulls - Allows the specification of the number of nulls to be
sent after the end of each line. Originally for terminals
connected to printers. (Does anyone use this option?)
:)lang - Allows the selection of a language. Settings from 1-12
depend on what languages (if any) have been specified in
the Opus control file.
Q)menu - If set to YES, the user will be returned to the menu from
which the user logged off during the last call (ie if the
user logged off from the files menu, the user would be
returned to the files menu on their nexct call thereby
bypassing the main menu). If set to NO, the user is
returned to the main menu at logon.
B)lock - If set to YES, the user does not wish to be interrupted
by a user on another line for an inter-line chat. Only of
use on Opus systems with multiple lines. If set to NO,
the user does not mind getting chat messages from a user
on another line.
C)lock - If set to YES, the time remaining for the user will be
displayed as part of the Opus prompt. If set to NO, the
time remianing will not be included in the Opus prompt.
P)ubln - Allows you to select which details about the user will be
included in the Opus user listing for public consumption.
Activates a pop-up menu which gives you the choice of
I)ncluding all details, toggling the N)ame field on/off,
toggling the C)ity field on/off, toggling the D)ate field
on/off and E)xcluding the user's details completely.
T)alker - For use by sight-impaired users who use a speech
synthesiser to "talk" the Opus output text. Limits
graphics information in Opus output text.
E)menu - Allows you to toggle on or off the Extra ANSI menus for
the user. If you toggle them on, make sure that the user
can handle ANSI character sequences!
D)efPr - Allows you to specify a default file transfer protocol
for the user. You should specify the first letter of the
desired protocol (ie the letter which the user would
otherwise normally choose from the Opus Select protocol
menu).
UNKNOWN COMMANDS
Unknown commands cause OUFM to display the Command Help Summary
shown in the following sample screen:
Page 16 Opus User File Manager v1.38
╔══════════════════════════════════════════════════════════════════════════════╗
║ R)ecno : 1 of 343 ID: 0661353901 First call date not logged ║
║ ╔══════════════════ Command Help Summary ══════════════════╗ ║
║ N)ame :║ ║ ║
║ U)ser :║ HOME First record | Last record END ║ ║
║ S)treet:║ <-- Prior record | Next record --> ║ ║
║ C)ity :║ ║ ║
║ ║ DOWN --- Change the active edit box --- UP ║ ║
║ K)eys :║ PgDn --- Toggle extra info displays --- PgUp ║42) ║
╚═════════║ = --- Manual < SEARCH > Auto tag --- ALT = ║═════════╝
┌─────────║ ALT C --- Combo tag Output tagged --- ALT O ║─────────┐
│ L)ast : ║ ║ │
│ X)piry: ║ . Tag record ! Shell to DOS ║ K │
│ mins: ║ G Global changes ESC Quit program ║ K │
│ A)ctn : ║ R Jump to Record no. Z Zap record ║ K │
│ ║ # Check index file * Update Caller ID ║ │
│ W)elcm: ║ DEL Delete Zapped records INS Insert new record ║0 │
└─────────║ ║─────────┘
┌─────────║ Top Edit Box Only ║─────────┐
│ H)elp : ║ ║r: Z │
│ V)ideo: ║ H Hide all passwords I Import User.Old ║ │
│ F)lash: ║ ║ │
│ M)ore : ╚═══════════════════ Any Key to Continue ══════════════════╝ │
│ X)tab : No U)sedB4: Yes Q)menu: No E)menu: No │
└──────────────────────────────────────────────────────────────────────────────┘
REVISION HISTORY
V0.00 -- 2 December 1989
V0.01 -- 3 December 1989
V0.02 -- 8 December 1989
V0.03 -- 9 December 1989
V0.04 -- 10 December 1989
V0.05 -- 12 December 1989
V0.06 -- 17 December 1989
V0.07 -- 18 December 1989
V0.08 -- 28 December 1989
V0.09 -- 29 December 1989
V0.10 -- 30-31 December 1989
V0.11 -- 1 January 1990
V0.12 -- 9 January 1990
Opus User File Manager v1.38 Page 17
V0.13 -- 18 January 1990
V0.14 -- 24 January 1990
V0.15 -- 26 January 1990 (morning)
V0.16 -- 26 January 1990 (evening)
V0.17 -- 27 January 1990
V0.18 -- 2-3 February 1990
V0.19 -- 5 February 1990
V0.20 -- 16 February 1990
V0.21 -- 27 February 1990
V0.22 -- 11 March 1990
V0.23 -- 12 March 1990
V1.00 -- 17 March 1990
V1.01 -- 22 April 1990
V1.02 -- 16 May 1990 (not released)
V1.03 -- 19 May 1990 (not released)
V1.04 -- 25 May 1990 (not released)
V1.05 -- 3 June 1990 (not released)
V1.06 -- 4 June 1990 (not released)
V1.07 -- 9 June 1990 (not released)
V1.08 -- 24 June 1990 (not released)
V1.09 -- 06 July 1990 (not released)
V1.10 -- 08 July 1990 (Public release 29 July 1990)
V1.11 -- 31 July 1990 (not released)
V1.12 -- 19 September 1990 (not released)
V1.13 -- 20/23 September 1990 (not released)
V1.14 -- 6 October 1990 (not released)
V1.15 -- 20 October 1990 (not released)
V1.16 -- 23 October 1990 (not released)
Page 18 Opus User File Manager v1.38
V1.17 -- 28 October 1990 (Public Release 28 October)
- replaced A)rea Hex/Dec with Opus 1.13 T)alker option
for speech & changed T)abs to X)tab, ie, eXpand tabs
- LAST OPUS 1.1x RELEASE ...
V1.20 -- 28 October 1990 (not released)
- first Opus 1.20 attempt
- removed user.idx code
- added caller_id to display
V1.21 -- 03 November 1990 (not released)
- added Zortech swap.obj module for spawns
- cleaned up display of caller_id
V1.22 -- 9 November 1990 (not released)
- fixed calculation of caller_id (fudate or ludate??)
V1.23 -- 15 December 1990 (not released)
- added CBT version of make_index_file()
V1.24 -- 16 December 1990 (not released)
- fixed index probs with CBT version of make_index_file()
- added custom error reporting for CBT functions
- added * option to top edit box to update caller_id
V1.25 -- 17 December 1990 (not released)
- fixed new * option to prevent ludate being updated
to current date
V1.26 -- 23 December 1990 (not released)
- cleaned up code (again)
- updated initial screen & edit boxes
- removed "B", "E", "+" and "-" global options
- added extra Opus 1.20 configuration bits
- ESC to quit program (previously Q)
- updated help screen
V1.27 -- 26 December 1990 (not released)
- who didn't keep a record!
V1.28 -- 26 January 1991 (not released)
- cleaned up code considerably (yet again)
- remake whole index after record deletion
(the make_index(2) function does not work if a record
is actually removed as all record file positions then
need updating ... oops)
V1.29 -- 22 & 26 February 1991 (not released)
- removed now obsolete L)ikes option
- enhanced & relocated matrix B)alance to top box
- added C)lock (time left prompt)
- added B)lock (block multi-user chat)
- if choose not to overwrite user.bak and therefore
not to purge file, index rebuild now skipped
Opus User File Manager v1.38 Page 19
V1.30 -- 21 May 1991 (beta release)
- new user file structure (for 1.20 release)
V1.31 -- 26 May 1991 (not released)
- major rearrangement of screen display to add the following:
Street address, Birth date, No of messages posted, No of
messages read and download limiting
- undocumented feature: 0 in middle edit box zeroes both the
number of minutes online today and the download limiting
V1.32 -- 28 May 1991 (not released)
- cleaned up screen popups for rearrangement of display in 1.31
- implemented global PgDn command to add: sysop comment field,
and user's logon answer to top edit box
- implemented global PgUp command to toggle PgDn info display
- updated help screen
- fixed incorrect search descriptions (when did that happen?)
V1.33 -- 11-12 June 1991 (not released)
- made PgDn a toggle, eliminated PgUp
- added search based on message & file area numbers for
Bev "does it check on marital status and income and debt,
matching that to gender" Freed; message area option only
shows on search menu if PgDn has not been toggled on
- added search based on "comment" and "myanswer" fields;
these options only show on search menu if PgDn has
been toggled (and the city, keys, telephone options
do not appear because this info is not currently
being displayed ... if you know what I mean).
- added search on days since last call EXACTLY and on
number of calls EXACTLY; enter number with a
trailing = sign, eg 30=
- added some living colour for Michael Masterson
- removed PreRegd access level (unusable)
- fixed inserted records to default to no OpEd and
no IBM chars
V1.34 -- 15 June 1991 (beta release)
- improved error reporting for dupe names in user file
V1.35 -- 14 July 1991 (public release)
- added -n Novell command line switch to allow program to
run on systems using Netware drivers (thanks to Jon
Sabol and Paul Lovrien for the debug reports)
- updated for Opus V1.70 release!
V1.36 -- 30 August 1991 (not releaesd)
- limited usrtel string length
- if you try to turn on HITECH and video is neither
ANSI nor AVATAR, an error message is displayed
- if you try to turn on OPED and video is neither ANSI
nor AVATAR and CLS is not on, an error message is
displayed
- if you try to turn off ANSI or AVATAR and OPED is
on, an error message is displayed
Page 20 Opus User File Manager v1.38
- if you try to turn off CLS and OPED is on, an
error message is displayed
- removed beta notice from initial screen (oops)
- msg and file area variables now unsigned
- msg and file areas may now be 5 digits long
- can now change matrix debit (enter number with a
trailing - to deduct from debit, eg 200- will
deduct 200 cents from the debit field and
-200- will add 200 cents to debit field)
- global adding/deleting/toggling of keys added
- screen width may now be 3 figures for those with 132 cols
- added global tag function toggle (invoke with . )
- added display of, ability to change and search on
SDS (sysop defined sections)
- added display of, ability to delete and search on
UDS (user defined sections)
- added global combo search/tagging option so that only
already tagged records will remain tagged on a
search match (invoke with ALT C instead of =)
- added global automatic search tagging so that all matching
records are automatically tagged (invoke with ALT =
instead of =)
- added untagging option to G)lobal menu
- added output to device/file option for tagged records
(invoke with ALT O)
V1.37 -- 3 NOV 1991 (not releaesd)
- made online total n/a if expiration not by minutes used
- cleaned up display so only active edit box dbl
- added append mode for ALT-O output filename
- new records now default to msg & file area 1
- added @ in middle edit box to set caller's logoff menu
V1.38 -- 30 MAR 1992 beta release, 3 MAY 1992 public release
- recompiled 30 NOV 91 version with Zortech C++ v3.00r4
- if you try to toggle video mode and OPED is on, only
Avatar & ANSI are available (removed error message)
- if you try to toggle video mode and HITECH is on, only
Avatar & ANSI are available (removed error message)
- if you try to toggle help mode and Avatar / ANSI is not
on, only Normal/Regular/Expert are available (not HITECH)
- added caller's default protocol to bottom edit box
- added search on birthdate (Steve Sharp)
- added automatic detection of Novell Netware
- on a shell to DOS, OUFM only takes up 2.8k memory!
BUGS/MITES/SUGGESTIONS
OUFM has been extensively tested on the Sentry BBS and Sentry's Shadow
BBS with no apparent ill effects. Should you discover what you suspect
is a bug, or even just a mite, or have any suggestions for the program
feel free to:
Opus User File Manager v1.38 Page 21
a) send a netmail message to me at the Sentry BBS or Sentry's
Shadow BBS (FidoNet Addresses: 3:711/401 and 3:711/501);
b) call the Sentry BBS on (02) 428-4687 (PEP modem) or Sentry's
Shadow BBS (02) 418-6682 (V32 modem) and leave me a message;
c) write to me at P.O. Box 1605, Macquarie Centre,
New South Wales 2113, Australia.
LICENSE
All Sysops are hereby authorised to use and/or distribute OUFM.EXE
provided only that (1) no money is charged for either its use or
distribution and (2) it is distributed together with this document
file.
DISCLAIMER OF LIABILITY
The author expressly disclaims any and all liability to any person in
respect of anything, and of the consequences of anything, done or
omitted to be done by OUFM.EXE. Be warned: Slippery when wet!
LATEST VERSION
The latest version of OUFM may always be Wazoo or Bark File Requested
from Sentry (3:711/401 - PEP modem) or Sentry's Shadow (3:711/501 -
V32 modem) outside of the Zone 1 mail hour and the Zone 3 mail hour
(plus and minus 1.5 hours), or downloaded by first time callers from
File Area #5 on Sentry or Sentry's Shadow. File requests for the magic
filename OUFM will always result in your obtaining the latest version.